home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 July: Mac OS SDK / Dev.CD Jul 99 SDK1.toast / Development Kits / Mac OS / Interfaces&Libraries / Universal / Interfaces / AIncludes / QD3DCamera.a < prev    next >
Encoding:
Text File  |  1998-08-17  |  14.0 KB  |  464 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        QD3DCamera.a
  3. ;
  4. ;    Contains:    Generic camera routines                                             
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.5.4
  7. ;                Release:    Universal Interfaces 3.2
  8. ;
  9. ;    Copyright:    © 1995-1998 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        For bug reports, consult the following page on
  12. ;                the World Wide Web:
  13. ;
  14. ;                    http://developer.apple.com/bugreporter/
  15. ;
  16. ;
  17.     IF &TYPE('__QD3DCAMERA__') = 'UNDEFINED' THEN
  18. __QD3DCAMERA__ SET 1
  19.  
  20.     IF &TYPE('__QD3D__') = 'UNDEFINED' THEN
  21.     include 'QD3D.a'
  22.     ENDIF
  23.  
  24. ; ******************************************************************************
  25. ; **                                                                             **
  26. ; **                            Data Structure Definitions                         **
  27. ; **                                                                             **
  28. ; ****************************************************************************
  29.  
  30. ; 
  31. ; *  The placement of the camera.
  32. ; 
  33.  
  34. TQ3CameraPlacement        RECORD 0
  35. cameraLocation             ds        TQ3Point3D        ; offset: $0 (0)        ;   Location point of the camera     
  36. pointOfInterest             ds        TQ3Point3D        ; offset: $C (12)        ;   Point of interest                 
  37. upVector                 ds        TQ3Vector3D        ; offset: $18 (24)        ;   "up" vector                     
  38. sizeof                     EQU *                    ; size:   $24 (36)
  39.                         ENDR
  40. ; 
  41. ; *  The range of the camera.
  42. ; 
  43.  
  44. TQ3CameraRange            RECORD 0
  45. hither                     ds        Float32            ; offset: $0 (0)        ;   Hither plane, measured from "from" towards "to"    
  46. yon                         ds        Float32            ; offset: $4 (4)        ;   Yon  plane, measured from "from" towards "to"     
  47. sizeof                     EQU *                    ; size:   $8 (8)
  48.                         ENDR
  49. ; 
  50. ; *  Viewport specification.  Origin is (-1, 1), and corresponds to the 
  51. ; *  upper left-hand corner; width and height maximum is (2.0, 2.0),
  52. ; *  corresponding to the lower left-hand corner of the window.  The
  53. ; *  TQ3Viewport specifies a part of the viewPlane that gets displayed 
  54. ; *    on the window that is to be drawn.
  55. ; *  Normally, it is set with an origin of (-1.0, 1.0), and a width and
  56. ; *  height of both 2.0, specifying that the entire window is to be
  57. ; *  drawn.  If, for example, an exposure event of the window exposed
  58. ; *  the right half of the window, you would set the origin to (0, 1),
  59. ; *  and the width and height to (1.0) and (2.0), respectively.
  60. ; *
  61. ; 
  62.  
  63. TQ3CameraViewPort        RECORD 0
  64. origin                     ds        TQ3Point2D        ; offset: $0 (0)
  65. width                     ds        Float32            ; offset: $8 (8)
  66. height                     ds        Float32            ; offset: $C (12)
  67. sizeof                     EQU *                    ; size:   $10 (16)
  68.                         ENDR
  69. TQ3CameraData            RECORD 0
  70. placement                 ds        TQ3CameraPlacement ; offset: $0 (0)
  71. range                     ds        TQ3CameraRange ; offset: $24 (36)
  72. viewPort                 ds        TQ3CameraViewPort ; offset: $2C (44)
  73. sizeof                     EQU *                    ; size:   $3C (60)
  74.                         ENDR
  75. ; 
  76. ; *  An orthographic camera.
  77. ; *
  78. ; *  The lens characteristics are set with the dimensions of a
  79. ; *  rectangular viewPort in the frame of the camera.
  80. ; 
  81.  
  82. TQ3OrthographicCameraData RECORD 0
  83. cameraData                 ds        TQ3CameraData    ; offset: $0 (0)
  84. left                     ds        Float32            ; offset: $3C (60)
  85. top                         ds        Float32            ; offset: $40 (64)
  86. right                     ds        Float32            ; offset: $44 (68)
  87. bottom                     ds        Float32            ; offset: $48 (72)
  88. sizeof                     EQU *                    ; size:   $4C (76)
  89.                         ENDR
  90. ; 
  91. ; *  A perspective camera specified in terms of an arbitrary view plane.
  92. ; *
  93. ; *  This is most useful when setting the camera to look at a particular
  94. ; *  object.  The viewPlane is set to distance from the camera to the object.
  95. ; *  The halfWidth is set to half the width of the cross section of the object,
  96. ; *  and the halfHeight equal to the halfWidth divided by the aspect ratio
  97. ; *  of the viewPort.
  98. ; * 
  99. ; *  This is the only perspective camera with specifications for off-axis
  100. ; *  viewing, which is desirable for scrolling.
  101. ; 
  102.  
  103. TQ3ViewPlaneCameraData    RECORD 0
  104. cameraData                 ds        TQ3CameraData    ; offset: $0 (0)
  105. viewPlane                 ds        Float32            ; offset: $3C (60)
  106. halfWidthAtViewPlane     ds        Float32            ; offset: $40 (64)
  107. halfHeightAtViewPlane     ds        Float32            ; offset: $44 (68)
  108. centerXOnViewPlane         ds        Float32            ; offset: $48 (72)
  109. centerYOnViewPlane         ds        Float32            ; offset: $4C (76)
  110. sizeof                     EQU *                    ; size:   $50 (80)
  111.                         ENDR
  112. ; 
  113. ; *    A view angle aspect camera is a perspective camera specified in 
  114. ; *    terms of the minimum view angle and the aspect ratio of X to Y.
  115. ; *
  116. ; 
  117.  
  118. TQ3ViewAngleAspectCameraData RECORD 0
  119. cameraData                 ds        TQ3CameraData    ; offset: $0 (0)
  120. fov                         ds        Float32            ; offset: $3C (60)
  121. aspectRatioXToY             ds        Float32            ; offset: $40 (64)
  122. sizeof                     EQU *                    ; size:   $44 (68)
  123.                         ENDR
  124. ; ******************************************************************************
  125. ; **                                                                             **
  126. ; **                            Generic Camera routines                             **
  127. ; **                                                                             **
  128. ; ****************************************************************************
  129.  
  130.  
  131. ;
  132. ; extern TQ3ObjectType Q3Camera_GetType(TQ3CameraObject camera)
  133. ;
  134.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  135.         IMPORT_CFM_FUNCTION Q3Camera_GetType
  136.     ENDIF
  137.  
  138. ;
  139. ; extern TQ3Status Q3Camera_SetData(TQ3CameraObject camera, const TQ3CameraData *cameraData)
  140. ;
  141.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  142.         IMPORT_CFM_FUNCTION Q3Camera_SetData
  143.     ENDIF
  144.  
  145. ;
  146. ; extern TQ3Status Q3Camera_GetData(TQ3CameraObject camera, TQ3CameraData *cameraData)
  147. ;
  148.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  149.         IMPORT_CFM_FUNCTION Q3Camera_GetData
  150.     ENDIF
  151.  
  152. ;
  153. ; extern TQ3Status Q3Camera_SetPlacement(TQ3CameraObject camera, const TQ3CameraPlacement *placement)
  154. ;
  155.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  156.         IMPORT_CFM_FUNCTION Q3Camera_SetPlacement
  157.     ENDIF
  158.  
  159. ;
  160. ; extern TQ3Status Q3Camera_GetPlacement(TQ3CameraObject camera, TQ3CameraPlacement *placement)
  161. ;
  162.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  163.         IMPORT_CFM_FUNCTION Q3Camera_GetPlacement
  164.     ENDIF
  165.  
  166. ;
  167. ; extern TQ3Status Q3Camera_SetRange(TQ3CameraObject camera, const TQ3CameraRange *range)
  168. ;
  169.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  170.         IMPORT_CFM_FUNCTION Q3Camera_SetRange
  171.     ENDIF
  172.  
  173. ;
  174. ; extern TQ3Status Q3Camera_GetRange(TQ3CameraObject camera, TQ3CameraRange *range)
  175. ;
  176.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  177.         IMPORT_CFM_FUNCTION Q3Camera_GetRange
  178.     ENDIF
  179.  
  180. ;
  181. ; extern TQ3Status Q3Camera_SetViewPort(TQ3CameraObject camera, const TQ3CameraViewPort *viewPort)
  182. ;
  183.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  184.         IMPORT_CFM_FUNCTION Q3Camera_SetViewPort
  185.     ENDIF
  186.  
  187. ;
  188. ; extern TQ3Status Q3Camera_GetViewPort(TQ3CameraObject camera, TQ3CameraViewPort *viewPort)
  189. ;
  190.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  191.         IMPORT_CFM_FUNCTION Q3Camera_GetViewPort
  192.     ENDIF
  193.  
  194. ;
  195. ; extern TQ3Status Q3Camera_GetWorldToView(TQ3CameraObject camera, TQ3Matrix4x4 *worldToView)
  196. ;
  197.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  198.         IMPORT_CFM_FUNCTION Q3Camera_GetWorldToView
  199.     ENDIF
  200.  
  201. ;
  202. ; extern TQ3Status Q3Camera_GetWorldToFrustum(TQ3CameraObject camera, TQ3Matrix4x4 *worldToFrustum)
  203. ;
  204.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  205.         IMPORT_CFM_FUNCTION Q3Camera_GetWorldToFrustum
  206.     ENDIF
  207.  
  208. ;
  209. ; extern TQ3Status Q3Camera_GetViewToFrustum(TQ3CameraObject camera, TQ3Matrix4x4 *viewToFrustum)
  210. ;
  211.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  212.         IMPORT_CFM_FUNCTION Q3Camera_GetViewToFrustum
  213.     ENDIF
  214.  
  215.  
  216. ; ******************************************************************************
  217. ; **                                                                             **
  218. ; **                            Specific Camera Routines                          **
  219. ; **                                                                             **
  220. ; ****************************************************************************
  221.  
  222. ; ******************************************************************************
  223. ; **                                                                             **
  224. ; **                            Orthographic Camera                                  **
  225. ; **                                                                             **
  226. ; ****************************************************************************
  227.  
  228. ;
  229. ; extern TQ3CameraObject Q3OrthographicCamera_New(const TQ3OrthographicCameraData *orthographicData)
  230. ;
  231.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  232.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_New
  233.     ENDIF
  234.  
  235. ;
  236. ; extern TQ3Status Q3OrthographicCamera_GetData(TQ3CameraObject camera, TQ3OrthographicCameraData *cameraData)
  237. ;
  238.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  239.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetData
  240.     ENDIF
  241.  
  242. ;
  243. ; extern TQ3Status Q3OrthographicCamera_SetData(TQ3CameraObject camera, const TQ3OrthographicCameraData *cameraData)
  244. ;
  245.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  246.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetData
  247.     ENDIF
  248.  
  249. ;
  250. ; extern TQ3Status Q3OrthographicCamera_SetLeft(TQ3CameraObject camera, float left)
  251. ;
  252.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  253.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetLeft
  254.     ENDIF
  255.  
  256. ;
  257. ; extern TQ3Status Q3OrthographicCamera_GetLeft(TQ3CameraObject camera, float *left)
  258. ;
  259.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  260.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetLeft
  261.     ENDIF
  262.  
  263. ;
  264. ; extern TQ3Status Q3OrthographicCamera_SetTop(TQ3CameraObject camera, float top)
  265. ;
  266.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  267.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetTop
  268.     ENDIF
  269.  
  270. ;
  271. ; extern TQ3Status Q3OrthographicCamera_GetTop(TQ3CameraObject camera, float *top)
  272. ;
  273.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  274.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetTop
  275.     ENDIF
  276.  
  277. ;
  278. ; extern TQ3Status Q3OrthographicCamera_SetRight(TQ3CameraObject camera, float right)
  279. ;
  280.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  281.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetRight
  282.     ENDIF
  283.  
  284. ;
  285. ; extern TQ3Status Q3OrthographicCamera_GetRight(TQ3CameraObject camera, float *right)
  286. ;
  287.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  288.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetRight
  289.     ENDIF
  290.  
  291. ;
  292. ; extern TQ3Status Q3OrthographicCamera_SetBottom(TQ3CameraObject camera, float bottom)
  293. ;
  294.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  295.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetBottom
  296.     ENDIF
  297.  
  298. ;
  299. ; extern TQ3Status Q3OrthographicCamera_GetBottom(TQ3CameraObject camera, float *bottom)
  300. ;
  301.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  302.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetBottom
  303.     ENDIF
  304.  
  305.  
  306. ; ******************************************************************************
  307. ; **                                                                             **
  308. ; **                            ViewPlane Camera                                  **
  309. ; **                                                                             **
  310. ; ****************************************************************************
  311.  
  312. ;
  313. ; extern TQ3CameraObject Q3ViewPlaneCamera_New(const TQ3ViewPlaneCameraData *cameraData)
  314. ;
  315.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  316.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_New
  317.     ENDIF
  318.  
  319. ;
  320. ; extern TQ3Status Q3ViewPlaneCamera_GetData(TQ3CameraObject camera, TQ3ViewPlaneCameraData *cameraData)
  321. ;
  322.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  323.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetData
  324.     ENDIF
  325.  
  326. ;
  327. ; extern TQ3Status Q3ViewPlaneCamera_SetData(TQ3CameraObject camera, const TQ3ViewPlaneCameraData *cameraData)
  328. ;
  329.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  330.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetData
  331.     ENDIF
  332.  
  333. ;
  334. ; extern TQ3Status Q3ViewPlaneCamera_SetViewPlane(TQ3CameraObject camera, float viewPlane)
  335. ;
  336.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  337.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetViewPlane
  338.     ENDIF
  339.  
  340. ;
  341. ; extern TQ3Status Q3ViewPlaneCamera_GetViewPlane(TQ3CameraObject camera, float *viewPlane)
  342. ;
  343.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  344.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetViewPlane
  345.     ENDIF
  346.  
  347. ;
  348. ; extern TQ3Status Q3ViewPlaneCamera_SetHalfWidth(TQ3CameraObject camera, float halfWidthAtViewPlane)
  349. ;
  350.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  351.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetHalfWidth
  352.     ENDIF
  353.  
  354. ;
  355. ; extern TQ3Status Q3ViewPlaneCamera_GetHalfWidth(TQ3CameraObject camera, float *halfWidthAtViewPlane)
  356. ;
  357.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  358.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetHalfWidth
  359.     ENDIF
  360.  
  361. ;
  362. ; extern TQ3Status Q3ViewPlaneCamera_SetHalfHeight(TQ3CameraObject camera, float halfHeightAtViewPlane)
  363. ;
  364.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  365.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetHalfHeight
  366.     ENDIF
  367.  
  368. ;
  369. ; extern TQ3Status Q3ViewPlaneCamera_GetHalfHeight(TQ3CameraObject camera, float *halfHeightAtViewPlane)
  370. ;
  371.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  372.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetHalfHeight
  373.     ENDIF
  374.  
  375. ;
  376. ; extern TQ3Status Q3ViewPlaneCamera_SetCenterX(TQ3CameraObject camera, float centerXOnViewPlane)
  377. ;
  378.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  379.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetCenterX
  380.     ENDIF
  381.  
  382. ;
  383. ; extern TQ3Status Q3ViewPlaneCamera_GetCenterX(TQ3CameraObject camera, float *centerXOnViewPlane)
  384. ;
  385.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  386.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetCenterX
  387.     ENDIF
  388.  
  389. ;
  390. ; extern TQ3Status Q3ViewPlaneCamera_SetCenterY(TQ3CameraObject camera, float centerYOnViewPlane)
  391. ;
  392.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  393.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetCenterY
  394.     ENDIF
  395.  
  396. ;
  397. ; extern TQ3Status Q3ViewPlaneCamera_GetCenterY(TQ3CameraObject camera, float *centerYOnViewPlane)
  398. ;
  399.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  400.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetCenterY
  401.     ENDIF
  402.  
  403.  
  404. ; ******************************************************************************
  405. ; **                                                                             **
  406. ; **                            View Angle Aspect Camera                          **
  407. ; **                                                                             **
  408. ; ****************************************************************************
  409.  
  410. ;
  411. ; extern TQ3CameraObject Q3ViewAngleAspectCamera_New(const TQ3ViewAngleAspectCameraData *cameraData)
  412. ;
  413.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  414.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_New
  415.     ENDIF
  416.  
  417. ;
  418. ; extern TQ3Status Q3ViewAngleAspectCamera_SetData(TQ3CameraObject camera, const TQ3ViewAngleAspectCameraData *cameraData)
  419. ;
  420.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  421.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_SetData
  422.     ENDIF
  423.  
  424. ;
  425. ; extern TQ3Status Q3ViewAngleAspectCamera_GetData(TQ3CameraObject camera, TQ3ViewAngleAspectCameraData *cameraData)
  426. ;
  427.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  428.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_GetData
  429.     ENDIF
  430.  
  431. ;
  432. ; extern TQ3Status Q3ViewAngleAspectCamera_SetFOV(TQ3CameraObject camera, float fov)
  433. ;
  434.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  435.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_SetFOV
  436.     ENDIF
  437.  
  438. ;
  439. ; extern TQ3Status Q3ViewAngleAspectCamera_GetFOV(TQ3CameraObject camera, float *fov)
  440. ;
  441.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  442.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_GetFOV
  443.     ENDIF
  444.  
  445. ;
  446. ; extern TQ3Status Q3ViewAngleAspectCamera_SetAspectRatio(TQ3CameraObject camera, float aspectRatioXToY)
  447. ;
  448.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  449.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_SetAspectRatio
  450.     ENDIF
  451.  
  452. ;
  453. ; extern TQ3Status Q3ViewAngleAspectCamera_GetAspectRatio(TQ3CameraObject camera, float *aspectRatioXToY)
  454. ;
  455.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  456.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_GetAspectRatio
  457.     ENDIF
  458.  
  459.  
  460.  
  461.  
  462.     ENDIF ; __QD3DCAMERA__ 
  463.  
  464.